---
title: Configuring Tencent Cloud COS Storage Service
description: >-
  Detailed steps to configure Tencent Cloud COS storage service for smooth file
  storage.
tags:
  - Tencent Cloud COS
  - S3 Storage
  - File Storage
  - Environment Variables
---

# Configuring Tencent Cloud COS Storage Service

We need to configure S3 storage service for file storage in the server-side database.

## Configuration Steps

<Steps>
  ### Configure and Obtain S3 Bucket

Create a new bucket on [Tencent Cloud COS](https://console.cloud.tencent.com/cos/bucket):

<Image
  alt={'Tencent Cloud COS Storage Interface'}
  src={'https://github.com/user-attachments/assets/d3626294-74ba-4944-9a63-052e6cf719ab'}
/>

Name the bucket (e.g., 'lobe'). Choose 'Public Read, Private Write', select any region, and keep other settings default.

<Image
  alt={'COS Create Bucket'}
  src={'https://github.com/user-attachments/assets/7257eb0e-4e2c-4db2-981d-354598e2c60f'}
/>

### Get Bucket-related Environment Variables

View bucket information in COS bucket overview:

<Image
  alt={'View Bucket Information'}
  src={'https://github.com/user-attachments/assets/d7d65e32-679d-4e50-a933-28cf5dde1330'}
/>

Corresponding environment variables:

```shell
S3_BUCKET=lobe-130xxxxxx2
S3_ENDPOINT=https://cos.ap-chengdu.myqcloud.com
S3_REGION=ap-chengdu
S3_PUBLIC_DOMAIN=https://lobe-1251234567.cos.ap-chengdu.myqcloud.com
```

  <Callout type={'warning'}>
    Note: `S3_ENDPOINT` should be `https://cos.ap-chengdu.myqcloud.com`, not `https://lobe-130xxxxxx2.cos.ap-chengdu.myqcloud.com`

    Include `https://` in the URL

</Callout>

### Configure CORS

Add the following in 'Security Management - CORS Settings':

<Image
  alt={'Configure CORS'}
  src={'https://github.com/user-attachments/assets/35164b25-c964-42ce-9cb0-32f6ebe1d07c'}
/>

### Get S3 Keys

Create a new SecretId and SecretKey at [Tencent Cloud API Key Management](https://console.cloud.tencent.com/cam/capi). Use as `S3_ACCESS_KEY_ID` and `S3_SECRET_ACCESS_KEY`.

</Steps>

### Additional Notes

- Consider setting up CDN acceleration for improved access speed and reduced costs.
- Use role management when creating API keys for enhanced security.
